Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie User Data

AddUserData

The AddUserData function allows your application to add an item to a user data list. You specify the user data list, the data to be added, and the data's type value.

pascal OSErr AddUserData (UserData theUserData, 
                           Handle data, OSType udType);

theUserData

Specifies the user data list for this operation. You obtain this item reference by calling the GetMovieUserData, GetTrackUserData, or GetMediaUserData function (described on page 2-215, page 2-216, and page 2-217, respectively).

data

Contains a handle to the data to be added to the user data list.

udType

Specifies the type that is to be assigned to the new item.

DESCRIPTION

The Movie Toolbox places the specified data into the user data and assigns an index value that identifies the new item.

ERROR CODES

Memory Manager errors